home *** CD-ROM | disk | FTP | other *** search
/ Stone Design / Stone Design.iso / Stone_Friends / Wave / WavesWorld / Documentation / WW3DKit / stuff / TurningRIBFilesIntoEveCode < prev    next >
Encoding:
Text File  |  1995-03-22  |  4.6 KB  |  101 lines
  1. This little note is intended to clue the interested reader into how to
  2. take random RIB files exported from any of various modeling packages
  3. and turn them into nice, useful eve code that can be incorporated into
  4. your own models.
  5.  
  6. Q: Where can I get RIB files?
  7.  
  8. A: Unfortunately, there is a dearth of models in RIB format available
  9. on the net.  Hopefully, with the advent of software like the
  10. WavesWorld's 3DKit for NEXTSTEP and the Blue Moon Rendering Tools (a
  11. shareware set of RenderMan compatible renderers for UNIX), this will
  12. change.  In the meantime, if you access to any of a wide variety of
  13. commercial modeling packages, many of them put out RIB already.
  14. Almost all Mac packages, and several high end packages (Alias,
  15. Vertigo) put out RIB.  Of course, all NEXTSTEP 3D apps put out RIB.
  16.  
  17. If you have a Macintosh, Pixar's ShowPlace product comes with a 
  18. really, really high quality set of clip art - it's worth the price
  19. of the product just for the clip art.  
  20.  
  21.  
  22. Q: I got a RIB file, what do I do before I start working on it?
  23.  
  24. A: Before dropping it into a WW3DWell, make sure that the file is
  25. probably an ASCII RIB file.  WavesWorld doesn't like ctrl-M, which is
  26. what the Mac uses instead of ctrl-J as a carriage return, so you should
  27. change that.  Next make sure that it's not a binary or mixed ASCII/binary
  28. file.  The RIB spec supports this, but I don't.  I have tools which I
  29. can't distribute that let me translate though, so send me the file and
  30. I'll send you back the pure ASCII equivalent.
  31.  
  32. Q: Now what?
  33.  
  34. A: Once you're reasonably certain you have a pure ASCII RIB file with
  35. valid UNIX carriage return/linefeeds, drop it into a WW3DWell.  If there
  36. are any errors, a panel will pop up telling you what the problem is.  
  37. The way this works is that the WW3DWell takes the RIB file and tries to
  38. turn it into a valid eve file.  For help in debugging, it writes this
  39. file to /tmp/tmp.eve.  It then "source"s that file.  Any errors that
  40. pop up will be referring to lines in that file, so this is important.  
  41.  
  42. Q: My model looks totally wrong: what do I do?
  43.  
  44. A: The most probable reason is that you need to have the "Treat
  45. TransformBegin/End pairs the same as AttributeBegin/End" on the Rib
  46. sub panel of the WW3DWell Control Panel.  Select that and drop the
  47. RIB file in again.  If it still looks wrong, send me mail.  
  48.  
  49. Q: I don't even see anything. What do I do?
  50.  
  51. A: Currently, the WW3DWell isn't very smart about where the camera
  52. starts off.  What it *should* do is look at the bounding box of the
  53. new model, look at the field of view of the current camera, and set up
  54. the camera so that you can see the whole new model.  Eventually, but
  55. for now...  Take a look at the bounding box info for the new model.
  56. If the number are very small (under 1.0) you probably want to zoom in;
  57. if the numbers are large (larger than, say, 5) you probably want to
  58. zoom out.
  59.  
  60. Q: Okay, I see my model.  What next?
  61.  
  62. A: The model you imported may have colors, opacity, and shaders that you
  63. don't want.  If you don't want these attributes in your model, you can
  64. check the appropriate choice on the "Rib" sub panel of the WW3DWell
  65. Control Panel and when the WW3DWell parses your rib file, it will
  66. ignore the corresponding commands.
  67.  
  68. On the other hand, your RIB file might contain important color
  69. information regarding your model.  Unfortunately, because of the way
  70. the WW3DKit works, it can't easily color shapes if you have your own
  71. Color commands as part of your shape.  Since the WW3DWell's way of
  72. showing you selected object assumes that you don't have any RiColor()
  73. calls in your model, this can be a problem.  Fortunately, there's a
  74. nice trick to get around this.  In your eve file, do a global replace
  75. and change all calls like:
  76.  
  77. Color {redValue greenValue blueValue};
  78.  
  79. into 
  80.  
  81. ArchiveRecord comment Color {redValue greenValue blueValue};
  82.  
  83. This will keep the information in your model at the appropriate place,
  84. but it will allow you to turn off the color calls while you browse
  85. your model.
  86.  
  87. The WW3DWell tries to figure out what to call each block of information
  88. imported from a RIB file, but not all RIB files actually name sections.  
  89.  
  90. A rather nice way to deal with this is to use the shape browser in the
  91. WW3DWell control panel.  By double-clicking on a name, you can edit
  92. it. Note that the WW3DWell's camera doesn't automatically track your
  93. selection; you need to click in the WW3DWell to get it to redraw so
  94. you can see the selection.  (This was a performance trade-off; many of
  95. my models are complicated and I hated waiting for the redraw each
  96. click - I should probably make this selectable...)
  97.  
  98. Once you've renamed everything to your liking and saved out the model
  99. to a new file, you can change the ArchiveRecord comments back to the
  100. real Color calls.
  101.